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1. Introdução 


O objetivo deste manual é facilitar o consumo dos dados da API da Campanha 
Nacional de Vacinação contra a Covid-19 disponível no endereço 
https://opendatasus.saude.gov.br/dataset/covid-19-vacinacao. 


2. Utilização da API 


API é um conjunto de rotinas e padrões de programação para acesso a um 
aplicativo de software ou plataforma baseado na Web. A sigla API refere-se ao 
termo em inglês "Application Programming Interface" que significa em tradução 
para o português "Interface de Programação de Aplicativos”. 


Através das APIs, os aplicativos podem se comunicar uns com os outros sem 
conhecimento ou intervenção dos usuários. Elas funcionam através da 
comunicação de diversos códigos, definindo comportamentos específicos de 
determinado objeto em uma interface. 


2.1. URL para consumo da API 
Para consumir os dados disponibilizados pela API, utilizaremos a seguinte URL: 
* https://imunizacao-es.saude.gov.br/ search 
Com a seguinte credencial de acesso: 
Usuário: imunizacao public 
Senha: glto5t&7r O+HTistigi 
2.2. Nomenclatura dos campos de Notificações 


A URL retorna os campos listados abaixo no formato .JSON, visando a facilidade 
de acesso ao dado por diversas ferramentas e linguagens. 


Por se tratar de uma dado semiestruturado deve-se ressaltar que nem todo 
registro possui todos as chaves. 
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3. Configurando para Consumir Informações da API 


Utilzaremos o aplicativo Postman (https://www.postman.com/) para exemplificar os procedimentos a serem executados para retornar os 
dados. 


No Postman, execute os seguintes procedimentos: 





Builder 


Ne ronment 
History 
——>——— GET Params Save 


Figura 1 — Tela inicial do Postman 
Selecionando a aba de Authorization selecione a opção “Basic Auth” conforme a figura 2. 
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— x 
NEW (1) Runner Import 3 Builder “a, O; Sign In [8] 4 & 4 


No Environment 


History 


Authorization Code 





= 
Figura 2 — Escolhendo o tipo de autenticação 


Tal ação exibirá os campos de usuário e senha para autenticação. Preencha os campos com o usuário e senha fornecidos no item 2.1 desse 
manual. Aproveite também para preencher a URL com o endereço que também está no item 2.1. O resultado está evidenciado na figura 3. 
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New Request 


[E] Save 


GET o https://imunizacao-es.saude.gov.br/ search 
Params Authorization € Headers (10) Body € Pre-request Script Tests Settings 


TYPE O) Heads up! These parameters hold sensitive data. To keep this data secure wi 


e working a collaborative environment, we recommend using variables 


Learn more about variables 2 
Basic Auth 


he authorization header will be automatically generated wher Username imunizacao. public 


you send the request. Learn more about authorization 2 


Password gitoSt&7r O+ETistigi 


Show Password 


Figura 3 — Preenchendo a autenticação e a o endereço da API 
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Nessa etapa, ao clicar no botão “Send” a API já é capaz de retornar uma resposta, com 10 registros, como mostra a figura 4. 


GET ” https://imunizacao-es.saude.gov.br/ search 








Params Authorization € Headers (8) Body Pre-request Script Tests Settings Cookies 
TYPE O) Heads up! These parameters hold sensitive data. To keep this data secure while working in a collaborative environment, we recommend using variables XxX 
Learn more about variables 2 
Basic Auth ” 
The authorization header will be automatically generated when Username imunizacao. public 
you send the request. Learn more about authorization 2 
Password qitoSt&7r O+4Tistigi 
Show Password 
3ody Cookies (1) Headers (8) Test Results É Status: 200 OK Time: 225ms Size: 14.95KB Save Response » 
Pretty Raw Preview Visualize ma 
E"took":10,"timed out“:false," shards":1"total“:3,"successful“:3,"skipped":0,“failed":0?,"hits":S"total“:[“value":10000,"“relation":“gte"?, “max score":1.0,"hits": [1º index":“desc-imunizacao", " 


—type":” doc”," id":"5c154264-8463-4ff4-bf7e-ciea249e6c00-iODO"," score“:1.0," source":i“vacina categoria codigo":"9","“vacina nome":“Covid-19-Coronavac-Sinovac/Butantan", “vacina lote":"202010024", 


“estabelecimento razaoSocial"“:“IRMANDADE DA SANTA CASA DE MISERICORDIA DE ARARAQUARA", “estalecimento noFantasia”: "SANTA CASA DE ARARAQUARA", “paciente endereco cep":“37993", “estabelecimento uf": “SP”, 
“sistema origem":“Pendente identificação", “paciente endereco nmMunicipio":"CAPETINGA", “paciente racaCor valor":“SEM INFORMACAO”, “paciente dataNascimento”:"1994-08-18", 

“vacina fabricante nome":“Sinovac”,“estabelecimento municipio nome” :“ARARAQUARA", “paciente idade":26,“vacina grupoAtendimento codigo":"000926",“vacina descricao dose 
“paciente nacionalidade enumNacionalidade":“B", “vacina codigo":“86", “estabelecimento municipio codigo":"350320","“gversion":"1", 

“paciente id": 





41º Dose", 


“b760f384076d5fcb10fada6525a203fb6f268e95b6372d6b538baaf7al42f4cc", “vacina categoria nome”:"Trabalhadores de Saúde",“vacina dataAplicacao”:“2021-02-17T00:00:00.000Z", 


“5c154264-8463-4ff4-bf7e-clea249e6c00-i10b0”,“Btimestamp":"“2021-02-23715:47:24.369Z",“paciente enumSexoBiologico":“F", “estabelecimento valor":“2082527","“paciente endereco uf":"MG”, 


“paciente endereco coPais":“10",“paciente endereco nmPais":“BRASIL",“paciente endereco colbgeMunicipio":"311240","vacina grupoAtendimento nome”:"Outros”,"“paciente racalor codigo”":“99"It, 


1" index”:"desc-imunizacao”,” type":" doc”," id": "eb8809f7-6f58-490a-876a-3204197f7e52-i0b0"," score":1.0," source":j“vacina categoria codigo":"2",“vacina nome":"Covid-19-Coronavac-Sinovac/Butantan”, 
“vacina lote”: 


"210013", “estabelecimento razaoSocial":"POMBAL PREFEITURA”",“estalecimento noFantasia":"CENTRO DE SAUDE AVELINO QUEIROGA",'"paciente endereco cep":“58840", "estabelecimento uf":"PB”, 


“sistema origem":"Novo PNI",“paciente endereco nmMunicipio":"POMBAL”","paciente racaCor valor":"BRANCA”,"paciente dataNascimento”:"1929-03-04", “vacina fabricante nome":"FUNDACAO BUTANTAN", 


“estabelecimento municipio nome”:"POMBAL","“paciente idade":91,"vacina grupoAtendimento codigo":"000205","vacina descricao dose”:” qm 


“document id”: 








Dose","paciente nacionalidade enumNacionalidade":"B”, 
“vacina codigo":"86", “estabelecimento municipio codigo":"251210","fversion":"1",“paciente id":"5a18878fc03056176979138e3d5a0c470081f92ede447e60e1b0d59f589200ff", "vacina categoria nome Faixa 


Etária”,“vacina dataAplicacao":"2021-02-12703:00:00.000Z","“document id":“eb8809f7-6f58-490a-876a-3204197f7e52-i0b0","Btimestamp”:"2021-02-23715:47:24.369Z2","paciente enumsSexoBiologico":"F”, 
“estabelecimento valor":"2592088", "paciente endereco uf":"PB",“paciente endereco coPais":"10",“paciente endereco nmPais":"BRASIL",“paciente endereco coIbgeMunicipio":"251210", 


“vacina grupoAtendimento nome":“Pessoas de 80 anos ou mais",“paciente racaCor codigo":“01",“vacina fabricante referencia":“Organization/61189445000156"?,17" index”:“desc-imunizacao",” type":" doc" 
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Figura 4 — Resposta da requisição 


Para consultar mais registros, você deve: 
1. Alterar o método da requisição de GET para POST, 
2. Alterar para a aba Body e marcar a opção raw, 
3. Alterar o tipo de envio de Text para JSON 


New Request 





GET o ttps nunizacao-es.saude.gov.br/. search 
Params Authorization O HReade (10) Body € Pre-request £ 
none form-data x-www-form-urlencoded 8 raw 
1 E 
À 
2 "size" :10000 
3 É 


4. 
na caixa de texto da página: 
t 
"size": 10000 
) 


Figura 5 — Passando parâmetros para a consulta 
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Caso o número de registros seja maior que 10000, retorne à Figura 5 e adicione o seguinte parâmetro ao final do endereço da API 
“Pscroll=1m” . O resultado da URL será: 


https:///munizacao-es.saude.gov.br/ search?scroll=ím 
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Essa requisição devolverá o mesmo JSON da figura 4 só que com uma nova chave " scroll id" como a imagem 6 evidencia: 





Vacinacao / New Request [EB Save =» soo o E 
PosT e https://imunizacao-es.saude.gov.br/ search?scroli=Im 
Params € Authorization € Headers (10) Body € Pre-request Script Tests Settings Cookies 
none form-data x-www-form-urlencoded 6 raw binary Graphol JSON » Beautify 
1 
2 | “size":10000 
3 B 
Body Cookies (1) Headers (8) Test Results 3 Status: 200 OK Time: 862ms Size: 14.2 MB Save Response 
Pretty Raw Preview Visualize JSON = F att maq 





pf £" scroll id”":"FGluv2x1ZGVfY29uUdGV4dF91dWlkDnF1ZXI5vGhlbkZldGNoAxvY1az1fcFpGXINBMj IwMWtSVF9pMId3AAAAAAASi -4WQWISROpEdUSTUHFBUFUOROkKOcHgyQRZKSVVhcy10bVFjU3pVMIpUdNhYRXINAAAAAAAZHOKWV3hBS3d IDGpTWkN T 
DVOdBYWMwyUULUOdxZfYkZQSUpseVFKT2x1eDdYZFFUaO1I3AAAAAAAGiSSWanNYbENOUjIUUXVLVXdrcGo5ScE43Zw==","took":129,"timed out":false," shards":I"total":3,"successful":3,"skipped":0,"failed":0f,"hits": 
I"total":1I“value":5937410 eq"Fr,"max score":1.0,"hits":[1" index":"desc-imunizacao”," type -—doc -id 5c154264-8463-4ff4-bf7e-ciea249e6c00-i0DO”"," score":1.0,” source”: 

I"vacina categoria codigo 9” ,"vacina nome” :"Covid-19-Coronavac-Sinovac/Butantan”", “vacina lote":"202010024", “estabelecimento razaoSocial": “IRMANDADE DA SANTA CASA DE MISERICORDIA DE 
ARARAQUARA”, "estalecimento noFantasia”:"SANTA CASA DE ARARAQUARA”, "paciente endereco cep”:"37993", "estabelecimento uf":"sP”, “sistema origem":"Pendente identificação”, 

“paciente endereco nmMunicipio” CAPETINGA”,"paciente racaCor valor”:"SEM INFORMACAO paciente dataNascimento":“1994-08-18",“vacina fabricante nome” :“Sinovac”, 

“estabelecimento municipio nome”:“ARARAQUARA”, "paciente idade":26,"vacina grupoAtendimento codigo”: "000926","vacina descricao dose":“ 2º Dose”, 

“paciente nacionalidade enumNacionalidade":“B",“vacina codigo":“86", “estabelecimento municipio codigo":“350320","“feversion":“1", 

“paciente id“:"“b760f384076d5fcb10fada6525a2d3fb6f268e95b6372d6b538baaf7al42f4cc","vacina categoria nome"“:"Trabalhadores de Saúde”,“vacina dataAplicacao":“2021-02-17T00:00:00.000Z", 
“document id":"5c154264-8463-4ff4-bf7e-clea249e6c00-iObO","Etimestamp":"2021-02-23715:47:24.3692","paciente enumsSexoBiologico":"“F","estabelecimento valor" :"2082527", 

“paciente endereco uf":"MG","paciente endereco coPais":"10","paciente endereco nmPais":"BRASIL","paciente endereco colbgeMunicipio":"311240","vacina grupoatendimento nome":"Qutros", 

"paciente racaCor codigo 99"7t, 1" index":"desc-imunizacao"," type -doe -— id": "ebss09f7-6f58-490a-876a-3204197f7e52-i0b0 -Score”":1.0," source” “vacina categoria codigo 
“vacina nome":"Covid-19-Coronavac-Sinovac/Butantan","vacina lote":"210013","estabelecimento razaoSocial":"POMBAL PREFEITURA”, "estalecimento noFantasia":"CENTRO DE SAUDE AVELINO QUEIROGA", 
“paciente endereco cep”:"58840", "estabelecimento uf":"PB”,"sistema origem":"Novo PNI","paciente endereco nmMunicipio":“POMBAL","“paciente racaCor valor":"BRANCA", 

“paciente dataNascimento 1929-03-04”, "vacina fabricante nome” :"FUNDACAO BUTANTAN”, “estabelecimento municipio nome” :"POMBAL paciente idade":91,"vacina grupoAtendimento codigo”":"000205" 
“vacina descricao dose”: 1º Dose","paciente nacionalidade enumNacionalidade":"B","vacina codigo":"B6","estabelecimento municipio codigo":"251210","gversion":"1”", 

“paciente id”: “5a18878fc03b56f76979138e3d5a0c470081f92ede447e60e1b0d59f589200ff".“vacina categoria nome”:“Faixa Etária".“vacina dataAolicacao":“2021-02-12703:00:00.000Z”. 








relation" 















































Figura 6 — Resposta da requisição search?scroll=1m 
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Com esse Id será possível pedir os dados da segunda “página” em diante. É importante chamar atenção de que essa requisição já traz 
o primeiro conjunto de elementos. Note que na linha 17 está o elemento hits que é vetor com os registros. Contudo, para as demais 
páginas, uma leve mudança no endereço e no corpo da requisição devem ser feitas. Recomenda-se a criação de uma nova aba no 
Postman: 


URL: https://imunizacao-es.saude.gov.br/ search/scroll 





Corpo: ( 
"scroll id": "INSERIR O SCROLL ID DA REQUISIÇÃO ANTERIOR", 
"scroll": "tm" 
New Request [E] Save Vá 
POST é https://imunizacao-es.saude.gov.br/ search/scroll Send 
Params Authorization €O Headers (10) Body € Pre-request Script Tests Settings Cookies 
none form-data x-www-form-urlencoded 6 raw binary GraphQL JSON » Beautify 
1 É 
2 “scroll id":“FGluy2x1ZGVfY29udGV4dF91dWlkDnF1ZXI5VGhlbkZldGNoAxY1azlfcFpGXINBM5 InMWt5SVF9pMId3AAAAAAASqgLkWQwWI4ROpEdUSTUHFBUFUOROKkOcHgyQRZKSVVhcy10b 
VFjU3pVM3pUdWwhYRXInAAAAAAAZPKkAWV3hBS3d IbGpTWkNDVOdBYwMwuUUUOdxZfYkZQSUpseVFKT2x1eDdYZFFUaG13AAAAAAAQp5OWanNYbENOUS LUUXVLVXdrcGo5cE43Zw==", 


3 “seroll":"Im” 


E 
[58] 


Figura 7 — Exemplo da requisição para consultar da segunda página em diante 
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É importante ressaltar que o scroll id é um valor temporário, por isso recomenda-se sempre copiar o valor da última resposta. 
Feito isso, o passo final é repetir a requisição até que o elemento hits venha vazio, conforme a figura 8: 
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POST betps://ela e saude.govbr/ sesrech 
. (3 Body € Code 
data encode € Dinary ISON tapplicacson/json) 
“scroll 19": “DnFIZXISVONIDETISCNOANANAAAAAXVVFESKTES IDAS IV gro cite TOPIC ANA AAAAS VN DOSES POL 14 NS VD LRIACIITDINADAAAAAS TELLANTOSI IOBWIUQUIFKIFYRF FC e jE UG =" 
seroll”: “Ja” 
Ri 
200 Ox Sé ms 


Body [04] 
-——— 
Frets; 
*OrPIIXIS VON DK TI SONcA AAA XVVPESKTOS DDS VÍ gd Lo TOPIC AAA AAA! TVR TOS SPILISLNSVDIR DGI TO IA É TESANTOS 1 DOC LUQUI KI FYASFCe Stud”, 
: false, 






sely": teve, 


"valçe”; 3744, 
“relation”: "eq" 





Figura 8 — Retorno após consumo de todos os dados da API 
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